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About 


You can share this PDF with anyone you feel could benefit from it, downloaded the latest version 
from: smalltalk 


It is an unofficial and free smalltalk ebook created for educational purposes. All the content is 
extracted from Stack Overflow Documentation, which is written by many hardworking individuals at 
Stack Overflow. It is neither affiliated with Stack Overflow nor official smalltalk. 


The content is released under Creative Commons BY-SA, and the list of contributors to each 
chapter are provided in the credits section at the end of this book. Images may be copyright of 
their respective owners unless otherwise specified. All trademarks and registered trademarks are 
the property of their respective company owners. 


Use the content presented in this book at your own risk; it is not guaranteed to be correct nor 
accurate, please send your feedback and corrections to info@zzzprojecits.com 
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Chapter 1: Getting started with smalltalk 


Remarks 


This section provides an overview of what smalltalk is, and why a developer might want to use it. 


It should also mention any large subjects within smalltalk, and link out to the related topics. Since 
the Documentation for Smalltalk is new, you may need to create initial versions of those related 
topics. 


Examples 


Installation or Setup 


The name Smalltalk usually refers to ANSI Smalltalk or Smalltalk 80 (of which the first is based 
on). While most implementations are close to the standard, they vary in different aspects (usually 
referred to as dialects). 


Each implementation has it's own method of installation. 


Well known FOSS implementations are: 


Pharo Started as a Squeak fork. (Windows/Linux/Mac OSX). Pharo has its own documentation 
entry at Stackoverflow Documentation, so please take a look there 


Squeak (Windows/Linux/Mac OSX) 
GNU Smalltalk (Windows/Linux/Mac OSX) 
Dolphin Smalltalk Originally commercial, now free open source. (Windows only) 


Cuis Smalltalk A Squeak fork with a focus on reducing system complexity. 


Commercial Smalltalks include: 


VisualWorks/Cincom Smalltalk Free trial available. 
VisualAge Smalltalk Originally by IBM, now Instatiations. Free trial available 
Smalltalk/x (Free for personal use?) 


GemsStone/s Free community edition available. 
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Other Smalltalk dialects 


Amber Smalltalk A Smalltalk that lives in the browser. 
Redline Smalltalk Smalltalk for the JVM. 


List of Smalltalk implementations on world.st 


Hello World in Smalltalk 


Transcript show: 'Hello World!'. 


This will print He110 wor1a: to the Transcript window in Smalltalk. transcript is the class that allows 
you to print to the Transcript window by sending the message show: to that object. The colon 
indicates that this message requires a parameter which is in this case a string. Strings are 
represented by single quotes and single quotes only since double quotes are reserved for 
comments in Smalltalk. 


Read Getting started with smalltalk online: https://riptutorial.com/smalltalk/topic/531 6/getting- 
started-with-smalltalk 
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Chapter 2: Smalltalk Syntax 


Examples 


Literals and comments 


Coments 


"Comments ar nclosed in double quotes. BEWARE: This is NOT a string!" 


"They can span 
multiple lines." 


Strings 


"Strings are enclosed in sigle quotes.' 
"Single quotes ar scaped with a single quote, like this: ''.' 


rere "<--This string contains one single quote" 


"Strings too can span 
multiple lines' 


uy VIN emoty Sticilags " 


Symbols 


tthilsaSymbol "Symbols are interned strings, used for method and variable names, 
and as values with fast equality checking." 
#'hello world' "A symbol with a space in it" 


#'' "An empty symbol, not very useful" 
#+ 
#1 "Not the integer 1" 


Characters 


$a "Characters are not strings. They are preceded by a $." 
SA "An uppercase character" 

$ "The spacecharacter!" 

$> "An unicode character" 

Si "Not to be confused with the number 1" 


Numbers 
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Numbers come in all varieties: 


Integers: 


e Decimal 

10 

-1 

0 

1000000000000000000000000000000000000000000 
e Hexadecimal 

16rAB1F 

16r0 

-16rFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 
e ScaledDecimal 

17s0 


3.14159265s8 


Other 
8r7731 "octal" 
2r1001 "binary" 


10r99987 "decimal again!" 
Floating point 
SAA eS, "2 floating-point numbers" 


Fractions 


Fractions are not the same as floating-point numbers, they're exact numbers (no rounding error). 


4/3 Hras rractiom y 
355/13} "A rational approximation to pi" 
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# (#abc 123) "A literal array with the symbol #abc and the number 123" 


Byte Arrays 


#[1 2 3 4] "Separators are blank" 
#[] "empty ByteArray" 
LO 0 0 0 255] "length is arbitrary" 


Dynamic arrays 


Dynamic arrays are built from expressions. Each expression inside the braces evaluates to a 
different value in the constructed array. 


(SQL OO, 3 + 2, 1 * 3) "A dynamic array built from 3 expressions" 


Blocks 


[ :p | p asString ] "A code block with a parameter p. 
Blocks are the same as lambdas in other languages" 


Some notes: 


Note that literal arrays use any kind and number of blanks as separators 


(258 Orasi Doldsz 2elOOl SA raisa) 
"is the same as:" 
# (256 

16rAB1F 

3.14s2 

2e OOL 

$A #this) 


Note also that you can compose literals 


PIAS Ioan EE] Aries LALA Lal] (four times 255) 


+(+[1 2 3] #('string' #symbol) ) (arrays of arrays) 
There is some "tolerance" to relaxed notation 


# (symbol) = #(#symbol) (missing # => symbol) 


ba (Sa Yav) (missing # => array) 
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But not here: 


+([1 2 31) ~= #(#[1 2 3]) (missing # => misinterpreted) 
However 
# (true nil false) (pseudo variables ok) 


But not here! 
(self) = #(#self) (missing # => symbol) 


As you can see there are a couple of inconsistencies: 


e While pseudo variables true, false and ni1 are accepted as literals inside arrays, the pseudo 
variables seif and super are interpreted as Symbols (using the more general rule for 
unqualified strings.) 


e While it is not mandatory to write +; for starting a nested array in an array and the 
parenthesis suffices, it is mandatory to write +; for starting a nested sytearray. 


Some of this was taken from: 


http://stackoverflow.com/a/37823203/4309858 
Message sending 


In Smalltalk almost everything you do is sending messages to objects (referred as calling methods 
in other languages). There are three types of messages: 


Unary messages: 


AL 2 5) Sale 
"This sends the #size message to the #(1 2 3) array. 
fsize is a unary message, because it takes no arguments." 


Binary messages: 


iL ap Z 
"This sends the #+ message and 2 as an argument to the object 1. 


#+ is a binary message because it takes one argument (2) 


and it's composed of one or two symbol characters" 
Keyword messages: 


Smalltalk” eulieyoheimliesics De 
"This sends #allButFirst: with argument 5 to the string 'Smalltalk', 
resulting in the new string 'talk'" 


32 tos 10 loys 2. 
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"This one sends the single message #to:by:, which takes two parameters (10 and 2) 


to the number 3. 


Ins sesule as} a collecucion windo 3, S, 7, eme E, Y 


Multiple messages in a statement are evaluated by the order of precedence 


unary > binary > keyword 


and left to right. 


1+ 2 * 3 " equals 9, because it evaluates left to right" 


1+ (2 * 3) " but you can use parenthesis" 
iL ice tila o e eh size by: 5-4 

"is the same as:" 
i tos (ta lo e cl) size ) loys (5= 4 ) 


If you want to send many messages to the same object, you can use the cascading operator ; 
(semicolon): 


OrderedCollection new 
add: #abc; 
add: #def; 
add: #ghi; 
yourself. 


"This first sends the message #new to the class OrderedCollection (#new is just a message, not 
an operator). It results in a new OrderedCollection. It then sends the new collection three times the 
message #add (with different arguments), and the message yourself." 


Classes and methods 


Classes and methods are usually defined in the Smalltalk IDE. 


Classes 


A class definition looks something like this in the browser: 


XMLTokenizer subclass: #XMLParser 


instanceVariableNames: '' 


classVariableNames: '' 
poolDictionaries: '' 
category: 'XML-Parser' 


This is actually the message the browser will send for you to create a new class in the system. (In 
this case it's #subclass:instanceVariableNames:classVariableNames:poolDictionaries:category:, put 
there are others that also make new classes). 


The first line shows which class you are subclassing (in this case it's XMLTokenizer) and the 
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name the new subclass will have (#XMLParser). 


The next three lines are used to define the variables the class and it's instances will have. 


Methods 


Methods look like this in the browser: 


aKeywordMethodWith: firstArgument and: secondArgument 
"Do something with an argument and return the result." 


“firstArgument doSomethingWith: secondArgument 


The -(caret) is the return operator. 


** anInteger 
"Raise me to anInteger" 
| templ temp2 | 


templ := 1. 

temp2 := 1. 

1 to: anInteger do: [ :i | templ := templ * self + temp2 - i ]. 
“templ 


this is not the right way to do exponentiation, but it shows a binary message definition (they're 
defined like any other message) and some method temporary variables (or method temporaries, 
temp1 and temp2) plus a block argument (/). 


Loops in Smalltalk 


For this example, an ordered Collection Will be used to show the different messages that can be 
sent to an orderedcollection Object to loop over the elements. 

The code below will instantiate an empty orderedcollection using the message new and then 
populate it with 4 numbers using the message ada: 


anOrderedCollection := OrderedCollection new. 
anOrderedCollection add: 1; add: 2; add: 3; add: 4. 


All of these messages will take a block as a parameter that will be evaluated for each of the 
elements inside the collection. 


1. do: 
This is the basic enumeration message. For example, if we want to print each element in the 
collection we can achieve that as such: 


anOrderedCollection do:[:each | Transcript show: each]. "Prints --> 1234" 


Each of the elements inside the collection will be defined as the user wishes using this 


https://riptutorial.com/ 9 


syntax: :each This do: loop will print every element in the collection to the transcript window. 


2. collect: 
The collect: message allows you to do something for each item in the collection and puts 
the result of your action in a new collection 
For example, if we wanted to multiply each element in our collection by 2 and add it to a new 
collection we can use the collect: message as such: 


evenCollection := anOrderedCollection collect:[:each | each*2]. "#(2 4 6 8)" 


3. select: 
The select: message allows you to create a sub-collection where items from the original 
collection are selected based on some condition being true for them. For example, if we 
wanted to create a new collection of odd numbers from our collection, we can use the 
select: Message as such: 


oddCollection := anOrderedCollection select:[:each | each odd]. 


Since each oda returns a Boolean, only the elements that make the Boolean return true will 
be added to oddcollection which will have +a 3). 


4. reject: 
This message works opposite to select: and rejects any elements that make the Boolean 
return true. Or, in other words it will select any elements that make the Boolean return false. 
For example if we wanted to build the same oddcollection like the previous example. We can 
USO reject: as such: 


oddCollection := anOrderedCollection reject:[:each | each even]. 


oddCollection Will again have #(1 3) as its elements. 


These are the four basic enumeration techniques in Smalltalk. However, feel free to browse the 
Collections Class for more messages that may be implemented. 


Read Smalltalk Syntax online: https://riptutorial.com/smalltalk/topic/5422/smalltalk-syntax 
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